home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / all.z / all
Encoding:
Text File  |  1998-10-30  |  3.9 KB  |  101 lines
  1. ALL(3I)                                                Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      AALLLL - Determines whether all values are true
  6.  
  7. SSYYNNOOPPSSIISS
  8.      AALLLL (([MMAASSKK==]_m_a_s_k [,,[DDIIMM==]_d_i_m]))
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      UNICOS, UNICOS/mk, and IRIX systems
  12.  
  13. SSTTAANNDDAARRDDSS
  14.      Fortran 90
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The AALLLL intrinsic function determines whether all values are true in
  18.      _m_a_s_k along dimension _d_i_m.  It accepts the following arguments:
  19.  
  20.      _m_a_s_k      Must be of type logical.  It must not be a scalar.
  21.  
  22.      _d_i_m       Must be a scalar.  It must be an integer value in the range
  23.                1 <= _d_i_m <= _n, where _n is the rank of _m_a_s_k.  The
  24.                corresponding actual argument must not be an optional dummy
  25.                argument.
  26.  
  27.      AALLLL is a transformational function.  The name of this intrinsic cannot
  28.      be passed as an argument.
  29.  
  30. RREETTUURRNN VVAALLUUEESS
  31.      The result is type logical.  It is a scalar result if _d_i_m is absent or
  32.      if _m_a_s_k has rank one.  Otherwise, the result is an array of rank _n-1
  33.      and of shape (_d , _d , ..., _d     , _d     , ..., _d ),
  34.                     1   2        _d_i_m-1   _d_i_m+1        _n
  35.      where (_d , _d , ..., _d )
  36.              1   2        _n
  37.      is the shape of _m_a_s_k.
  38.  
  39.      The result of AALLLL((_m_a_s_k)) has the value TTRRUUEE if all the elements of _m_a_s_k
  40.      are TTRRUUEE or if _m_a_s_k is a zero-sized array.  The result has the value
  41.      FFAALLSSEE if any element of _m_a_s_k is FFAALLSSEE.
  42.  
  43.      If _m_a_s_k has rank one, AALLLL((_m_a_s_k,, _d_i_m)) has a value equal to that of
  44.      AALLLL((_m_a_s_k)).  Otherwise, the value of
  45.      element (_s , _s , ..., _s     , _s     , ..., _s )
  46.                1   2        _d_i_m-1   _d_i_m+1        _n
  47.      of AALLLL((_m_a_s_k,, _d_i_m)) is equal to
  48.      AALLLL((_m_a_s_k (_s , _s , ..., _s     , : , _s     , ..., _s )).
  49.                 1   2        _d_i_m-1       _d_i_m+1        _n
  50.  
  51. EEXXAAMMPPLLEESS
  52.      Example 1:
  53.  
  54.      * AALLLL (( ((// ..TTRRUUEE..,, ..FFAALLSSEE..,, ..TTRRUUEE.. //)) )) is false.
  55.  
  56.      * AALLLL((_a_r_r_a_y)) is ..TTRRUUEE.. when _a_r_r_a_y is a zero-sized array.
  57.  
  58.      Example 2:  Assume that BB and CC are arrays as follows:
  59.  
  60.      BB is the following array:
  61.  
  62.         | 1 3 5 |
  63.  
  64.         | 2 4 6 |
  65.  
  66.      CC is the following array:
  67.  
  68.         | 0 3 5 |
  69.  
  70.         | 7 4 8 |
  71.  
  72.      * AALLLL (( BB ..NNEE.. CC )) is ..FFAALLSSEE..
  73.  
  74.      * AALLLL (( BB ..NNEE.. CC,, DDIIMM==11)) is [[..TTRRUUEE..,, ..FFAALLSSEE..,, ..FFAALLSSEE..]]
  75.  
  76.      * AALLLL (( BB ..NNEE.. CC,, DDIIMM==22)) is [[..FFAALLSSEE..,, ..FFAALLSSEE..]]
  77.  
  78.      * AALLLL (( BB ..NNEE.. 11 )) is ..FFAALLSSEE.. because there is one false element in
  79.        the mask.
  80.  
  81.      Example 3:  Assume that array NN is as follows:
  82.  
  83.         | 0 1 2 3 |
  84.  
  85.         | 4 5 6 7 |
  86.  
  87.         | 8 9 0 1 |
  88.  
  89.      In an array section reference, you can expect the following results:
  90.  
  91.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)))) is ..FFAALLSSEE..
  92.  
  93.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)),,DDIIMM==11)) is [[..TTRRUUEE..,, ..FFAALLSSEE..,, ..TTRRUUEE..]]
  94.  
  95.      * AALLLL((((NN((22::33,,22::44))..NNEE..00)),,DDIIMM==22)) is [[..TTRRUUEE..,, ..FFAALLSSEE..]]
  96.  
  97. SSEEEE AALLSSOO
  98.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2138, for the
  99.      printed version of this man page.
  100.  
  101.